<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkNotebook: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="LayoutContainers.html" title="Layout Containers">
<link rel="prev" href="GtkLayout.html" title="GtkLayout">
<link rel="next" href="GtkExpander.html" title="GtkExpander">
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GtkNotebook.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GtkNotebook.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
                  <a href="#GtkNotebook.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
                  <a href="#GtkNotebook.properties" class="shortcut">Properties</a></span><span id="nav_child_properties">  <span class="dim">|</span> 
                  <a href="#GtkNotebook.child-properties" class="shortcut">Child Properties</a></span><span id="nav_style_properties">  <span class="dim">|</span> 
                  <a href="#GtkNotebook.style-properties" class="shortcut">Style Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
                  <a href="#GtkNotebook.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="LayoutContainers.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GtkLayout.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GtkExpander.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GtkNotebook"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkNotebook.top_of_page"></a>GtkNotebook</span></h2>
<p>GtkNotebook — A tabbed notebook container</p>
</td>
<td class="gallery_image" valign="top" align="right"><img src="notebook.png"></td>
</tr></table></div>
<div class="refsect1">
<a name="GtkNotebook.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-new" title="gtk_notebook_new ()">gtk_notebook_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-append-page" title="gtk_notebook_append_page ()">gtk_notebook_append_page</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-append-page-menu" title="gtk_notebook_append_page_menu ()">gtk_notebook_append_page_menu</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-prepend-page" title="gtk_notebook_prepend_page ()">gtk_notebook_prepend_page</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-prepend-page-menu" title="gtk_notebook_prepend_page_menu ()">gtk_notebook_prepend_page_menu</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-insert-page" title="gtk_notebook_insert_page ()">gtk_notebook_insert_page</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-insert-page-menu" title="gtk_notebook_insert_page_menu ()">gtk_notebook_insert_page_menu</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-remove-page" title="gtk_notebook_remove_page ()">gtk_notebook_remove_page</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-detach-tab" title="gtk_notebook_detach_tab ()">gtk_notebook_detach_tab</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-page-num" title="gtk_notebook_page_num ()">gtk_notebook_page_num</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-next-page" title="gtk_notebook_next_page ()">gtk_notebook_next_page</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-prev-page" title="gtk_notebook_prev_page ()">gtk_notebook_prev_page</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-reorder-child" title="gtk_notebook_reorder_child ()">gtk_notebook_reorder_child</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-pos" title="gtk_notebook_set_tab_pos ()">gtk_notebook_set_tab_pos</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-show-tabs" title="gtk_notebook_set_show_tabs ()">gtk_notebook_set_show_tabs</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-show-border" title="gtk_notebook_set_show_border ()">gtk_notebook_set_show_border</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-scrollable" title="gtk_notebook_set_scrollable ()">gtk_notebook_set_scrollable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-popup-enable" title="gtk_notebook_popup_enable ()">gtk_notebook_popup_enable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-popup-disable" title="gtk_notebook_popup_disable ()">gtk_notebook_popup_disable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-current-page" title="gtk_notebook_get_current_page ()">gtk_notebook_get_current_page</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-menu-label" title="gtk_notebook_get_menu_label ()">gtk_notebook_get_menu_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-nth-page" title="gtk_notebook_get_nth_page ()">gtk_notebook_get_nth_page</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-n-pages" title="gtk_notebook_get_n_pages ()">gtk_notebook_get_n_pages</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-label" title="gtk_notebook_get_tab_label ()">gtk_notebook_get_tab_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-menu-label" title="gtk_notebook_set_menu_label ()">gtk_notebook_set_menu_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-menu-label-text" title="gtk_notebook_set_menu_label_text ()">gtk_notebook_set_menu_label_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-label" title="gtk_notebook_set_tab_label ()">gtk_notebook_set_tab_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-label-text" title="gtk_notebook_set_tab_label_text ()">gtk_notebook_set_tab_label_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-reorderable" title="gtk_notebook_set_tab_reorderable ()">gtk_notebook_set_tab_reorderable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-detachable" title="gtk_notebook_set_tab_detachable ()">gtk_notebook_set_tab_detachable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-menu-label-text" title="gtk_notebook_get_menu_label_text ()">gtk_notebook_get_menu_label_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-scrollable" title="gtk_notebook_get_scrollable ()">gtk_notebook_get_scrollable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-show-border" title="gtk_notebook_get_show_border ()">gtk_notebook_get_show_border</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-show-tabs" title="gtk_notebook_get_show_tabs ()">gtk_notebook_get_show_tabs</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-label-text" title="gtk_notebook_get_tab_label_text ()">gtk_notebook_get_tab_label_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="returnvalue">GtkPositionType</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-pos" title="gtk_notebook_get_tab_pos ()">gtk_notebook_get_tab_pos</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-reorderable" title="gtk_notebook_get_tab_reorderable ()">gtk_notebook_get_tab_reorderable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-detachable" title="gtk_notebook_get_tab_detachable ()">gtk_notebook_get_tab_detachable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guint16</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-hborder" title="gtk_notebook_get_tab_hborder ()">gtk_notebook_get_tab_hborder</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guint16</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-vborder" title="gtk_notebook_get_tab_vborder ()">gtk_notebook_get_tab_vborder</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-current-page" title="gtk_notebook_set_current_page ()">gtk_notebook_set_current_page</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-group-name" title="gtk_notebook_set_group_name ()">gtk_notebook_set_group_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-group-name" title="gtk_notebook_get_group_name ()">gtk_notebook_get_group_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-set-action-widget" title="gtk_notebook_set_action_widget ()">gtk_notebook_set_action_widget</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkNotebook.html#gtk-notebook-get-action-widget" title="gtk_notebook_get_action_widget ()">gtk_notebook_get_action_widget</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkNotebook.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--enable-popup" title="The “enable-popup” property">enable-popup</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--group-name" title="The “group-name” property">group-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--page" title="The “page” property">page</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--scrollable" title="The “scrollable” property">scrollable</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--show-border" title="The “show-border” property">show-border</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--show-tabs" title="The “show-tabs” property">show-tabs</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="type">GtkPositionType</span></a></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--tab-pos" title="The “tab-pos” property">tab-pos</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkNotebook.child-properties"></a><h2>Child Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="child_properties_type">
<col width="300px" class="child_properties_name">
<col width="200px" class="child_properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-detachable" title="The “detachable” child property">detachable</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-menu-label" title="The “menu-label” child property">menu-label</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-position" title="The “position” child property">position</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-reorderable" title="The “reorderable” child property">reorderable</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-tab-expand" title="The “tab-expand” child property">tab-expand</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-tab-fill" title="The “tab-fill” child property">tab-fill</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-tab-label" title="The “tab-label” child property">tab-label</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkNotebook.style-properties"></a><h2>Style Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="style_properties_type">
<col width="300px" class="style_properties_name">
<col width="200px" class="style_properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-arrow-spacing" title="The “arrow-spacing” style property">arrow-spacing</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-backward-stepper" title="The “has-backward-stepper” style property">has-backward-stepper</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-forward-stepper" title="The “has-forward-stepper” style property">has-forward-stepper</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-secondary-backward-stepper" title="The “has-secondary-backward-stepper” style property">has-secondary-backward-stepper</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-secondary-forward-stepper" title="The “has-secondary-forward-stepper” style property">has-secondary-forward-stepper</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-tab-gap" title="The “has-tab-gap” style property">has-tab-gap</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-initial-gap" title="The “initial-gap” style property">initial-gap</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-tab-curvature" title="The “tab-curvature” style property">tab-curvature</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-tab-overlap" title="The “tab-overlap” style property">tab-overlap</a></td>
<td class="property_flags">Read</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkNotebook.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signal_proto_type">
<col width="300px" class="signal_proto_name">
<col width="200px" class="signal_proto_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-change-current-page" title="The “change-current-page” signal">change-current-page</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type">
<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="returnvalue">GtkNotebook</span></a>*</td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-create-window" title="The “create-window” signal">create-window</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-focus-tab" title="The “focus-tab” signal">focus-tab</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-move-focus-out" title="The “move-focus-out” signal">move-focus-out</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-page-added" title="The “page-added” signal">page-added</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-page-removed" title="The “page-removed” signal">page-removed</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-page-reordered" title="The “page-reordered” signal">page-reordered</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-reorder-tab" title="The “reorder-tab” signal">reorder-tab</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-select-page" title="The “select-page” signal">select-page</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-switch-page" title="The “switch-page” signal">switch-page</a></td>
<td class="signal_flags">Run Last</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkNotebook.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody><tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkNotebook.html#GtkNotebook-struct" title="struct GtkNotebook">GtkNotebook</a></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkNotebook.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    GObject
    <span class="lineart">╰──</span> GInitiallyUnowned
        <span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
            <span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
                <span class="lineart">╰──</span> GtkNotebook
</pre>
</div>
<div class="refsect1">
<a name="GtkNotebook.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkNotebook implements
 AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkNotebook.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GtkNotebook.description"></a><h2>Description</h2>
<p>The <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> widget is a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> whose children are pages that
can be switched between using tab labels along one edge.</p>
<p>There are many configuration options for GtkNotebook. Among other
things, you can choose on which edge the tabs appear
(see <a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-pos" title="gtk_notebook_set_tab_pos ()"><code class="function">gtk_notebook_set_tab_pos()</code></a>), whether, if there are too many
tabs to fit the notebook should be made bigger or scrolling
arrows added (see <a class="link" href="GtkNotebook.html#gtk-notebook-set-scrollable" title="gtk_notebook_set_scrollable ()"><code class="function">gtk_notebook_set_scrollable()</code></a>), and whether there
will be a popup menu allowing the users to switch pages.
(see <a class="link" href="GtkNotebook.html#gtk-notebook-popup-enable" title="gtk_notebook_popup_enable ()"><code class="function">gtk_notebook_popup_enable()</code></a>, <a class="link" href="GtkNotebook.html#gtk-notebook-popup-disable" title="gtk_notebook_popup_disable ()"><code class="function">gtk_notebook_popup_disable()</code></a>)</p>
<div class="refsect2">
<a name="id-1.3.7.16.12.4"></a><h3>GtkNotebook as GtkBuildable</h3>
<p>The GtkNotebook implementation of the <a class="link" href="GtkBuildable.html" title="GtkBuildable"><span class="type">GtkBuildable</span></a> interface
supports placing children into tabs by specifying “tab” as the
“type” attribute of a &lt;child&gt; element. Note that the content
of the tab must be created before the tab can be filled.
A tab child can be specified without specifying a &lt;child&gt;
type attribute.</p>
<p>To add a child widget in the notebooks action area, specify
"action-start" or “action-end” as the “type” attribute of the
&lt;child&gt; element.</p>
<p>An example of a UI definition fragment with GtkNotebook:</p>
<div class="informalexample">
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
    <tbody>
      <tr>
        <td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12</pre></td>
        <td class="listing_code"><pre class="programlisting"><span class="o">&lt;</span><span class="n">object</span> <span class="n">class</span><span class="o">=</span><span class="s">&quot;GtkNotebook&quot;</span><span class="o">&gt;</span>
  <span class="o">&lt;</span><span class="n">child</span><span class="o">&gt;</span>
    <span class="o">&lt;</span><span class="n">object</span> <span class="n">class</span><span class="o">=</span><span class="s">&quot;GtkLabel&quot;</span> <span class="n">id</span><span class="o">=</span><span class="s">&quot;notebook-content&quot;</span><span class="o">&gt;</span>
      <span class="o">&lt;</span><span class="n">property</span> <span class="n">name</span><span class="o">=</span><span class="s">&quot;label&quot;</span><span class="o">&gt;</span><span class="n">Content</span><span class="o">&lt;/</span><span class="n">property</span><span class="o">&gt;</span>
    <span class="o">&lt;/</span><span class="n">object</span><span class="o">&gt;</span>
  <span class="o">&lt;/</span><span class="n">child</span><span class="o">&gt;</span>
  <span class="o">&lt;</span><span class="n">child</span> <span class="n">type</span><span class="o">=</span><span class="s">&quot;tab&quot;</span><span class="o">&gt;</span>
    <span class="o">&lt;</span><span class="n">object</span> <span class="n">class</span><span class="o">=</span><span class="s">&quot;GtkLabel&quot;</span> <span class="n">id</span><span class="o">=</span><span class="s">&quot;notebook-tab&quot;</span><span class="o">&gt;</span>
      <span class="o">&lt;</span><span class="n">property</span> <span class="n">name</span><span class="o">=</span><span class="s">&quot;label&quot;</span><span class="o">&gt;</span><span class="n">Tab</span><span class="o">&lt;/</span><span class="n">property</span><span class="o">&gt;</span>
    <span class="o">&lt;/</span><span class="n">object</span><span class="o">&gt;</span>
  <span class="o">&lt;/</span><span class="n">child</span><span class="o">&gt;</span>
<span class="o">&lt;/</span><span class="n">object</span><span class="o">&gt;</span></pre></td>
      </tr>
    </tbody>
  </table>
</div>

<p></p>
</div>
<hr>
<div class="refsect2">
<a name="id-1.3.7.16.12.5"></a><h3>CSS nodes</h3>
<div class="informalexample">
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
    <tbody>
      <tr>
        <td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17</pre></td>
        <td class="listing_code"><pre class="programlisting"><span class="n">notebook</span>
<span class="err">├──</span> <span class="n">header</span><span class="p">.</span><span class="n">top</span>
<span class="err">│</span>   <span class="err">├──</span> <span class="p">[</span><span class="o">&lt;</span><span class="n">action</span> <span class="n">widget</span><span class="o">&gt;</span><span class="p">]</span>
<span class="err">│</span>   <span class="err">├──</span> <span class="n">tabs</span>
<span class="err">│</span>   <span class="err">│</span>   <span class="err">├──</span> <span class="p">[</span><span class="n">arrow</span><span class="p">]</span>
<span class="err">│</span>   <span class="err">│</span>   <span class="err">├──</span> <span class="n">tab</span>
<span class="err">│</span>   <span class="err">│</span>   <span class="err">│</span>   <span class="err">╰──</span> <span class="o">&lt;</span><span class="n">tab</span> <span class="n">label</span><span class="o">&gt;</span>
<span class="err">┊</span>   <span class="err">┊</span>   <span class="err">┊</span>
<span class="err">│</span>   <span class="err">│</span>   <span class="err">├──</span> <span class="n">tab</span><span class="p">[.</span><span class="n">reorderable</span><span class="o">-</span><span class="n">page</span><span class="p">]</span>
<span class="err">│</span>   <span class="err">│</span>   <span class="err">│</span>   <span class="err">╰──</span> <span class="o">&lt;</span><span class="n">tab</span> <span class="n">label</span><span class="o">&gt;</span>
<span class="err">│</span>   <span class="err">│</span>   <span class="err">╰──</span> <span class="p">[</span><span class="n">arrow</span><span class="p">]</span>
<span class="err">│</span>   <span class="err">╰──</span> <span class="p">[</span><span class="o">&lt;</span><span class="n">action</span> <span class="n">widget</span><span class="o">&gt;</span><span class="p">]</span>
<span class="err">│</span>
<span class="err">╰──</span> <span class="n">stack</span>
    <span class="err">├──</span> <span class="o">&lt;</span><span class="n">child</span><span class="o">&gt;</span>
    <span class="err">┊</span>
    <span class="err">╰──</span> <span class="o">&lt;</span><span class="n">child</span><span class="o">&gt;</span></pre></td>
      </tr>
    </tbody>
  </table>
</div>

<p></p>
<p>GtkNotebook has a main CSS node with name notebook, a subnode
with name header and below that a subnode with name tabs which
contains one subnode per tab with name tab.</p>
<p>If action widgets are present, their CSS nodes are placed next
to the tabs node. If the notebook is scrollable, CSS nodes with
name arrow are placed as first and last child of the tabs node.</p>
<p>The main node gets the .frame style class when the notebook
has a border (see <a class="link" href="GtkNotebook.html#gtk-notebook-set-show-border" title="gtk_notebook_set_show_border ()"><code class="function">gtk_notebook_set_show_border()</code></a>).</p>
<p>The header node gets one of the style class .top, .bottom,
.left or .right, depending on where the tabs are placed. For
reorderable pages, the tab node gets the .reorderable-page class.</p>
<p>A tab node gets the .dnd style class while it is moved with drag-and-drop.</p>
<p>The nodes are always arranged from left-to-right, regarldess of text direction.</p>
</div>
</div>
<div class="refsect1">
<a name="GtkNotebook.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-notebook-new"></a><h3>gtk_notebook_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_notebook_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Creates a new <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> widget with no pages.</p>
<div class="refsect3">
<a name="gtk-notebook-new.returns"></a><h4>Returns</h4>
<p> the newly created <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-append-page"></a><h3>gtk_notebook_append_page ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_notebook_append_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>);</pre>
<p>Appends a page to <em class="parameter"><code>notebook</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-append-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tab_label</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-append-page.returns"></a><h4>Returns</h4>
<p> the index (starting from 0) of the appended
page in the notebook, or -1 if function fails</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-append-page-menu"></a><h3>gtk_notebook_append_page_menu ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_notebook_append_page_menu (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu_label</code></em>);</pre>
<p>Appends a page to <em class="parameter"><code>notebook</code></em>
, specifying the widget to use as the
label in the popup menu.</p>
<div class="refsect3">
<a name="gtk-notebook-append-page-menu.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tab_label</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>menu_label</p></td>
<td class="parameter_description"><p>the widget to use as a label for the
page-switch menu, if that is enabled. If <code class="literal">NULL</code>, and <em class="parameter"><code>tab_label</code></em>
is a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> or <code class="literal">NULL</code>, then the menu label will be a newly
created label with the same text as <em class="parameter"><code>tab_label</code></em>
; if <em class="parameter"><code>tab_label</code></em>
is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, <em class="parameter"><code>menu_label</code></em>
must be specified if the
page-switch menu is to be used. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-append-page-menu.returns"></a><h4>Returns</h4>
<p> the index (starting from 0) of the appended
page in the notebook, or -1 if function fails</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-prepend-page"></a><h3>gtk_notebook_prepend_page ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_notebook_prepend_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                           <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                           <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>);</pre>
<p>Prepends a page to <em class="parameter"><code>notebook</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-prepend-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tab_label</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-prepend-page.returns"></a><h4>Returns</h4>
<p> the index (starting from 0) of the prepended
page in the notebook, or -1 if function fails</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-prepend-page-menu"></a><h3>gtk_notebook_prepend_page_menu ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_notebook_prepend_page_menu (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>,
                                <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu_label</code></em>);</pre>
<p>Prepends a page to <em class="parameter"><code>notebook</code></em>
, specifying the widget to use as the
label in the popup menu.</p>
<div class="refsect3">
<a name="gtk-notebook-prepend-page-menu.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tab_label</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>menu_label</p></td>
<td class="parameter_description"><p>the widget to use as a label for the
page-switch menu, if that is enabled. If <code class="literal">NULL</code>, and <em class="parameter"><code>tab_label</code></em>
is a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> or <code class="literal">NULL</code>, then the menu label will be a newly
created label with the same text as <em class="parameter"><code>tab_label</code></em>
; if <em class="parameter"><code>tab_label</code></em>
is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, <em class="parameter"><code>menu_label</code></em>
must be specified if the
page-switch menu is to be used. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-prepend-page-menu.returns"></a><h4>Returns</h4>
<p> the index (starting from 0) of the prepended
page in the notebook, or -1 if function fails</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-insert-page"></a><h3>gtk_notebook_insert_page ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_notebook_insert_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>,
                          <em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
<p>Insert a page into <em class="parameter"><code>notebook</code></em>
 at the given position.</p>
<div class="refsect3">
<a name="gtk-notebook-insert-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tab_label</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>position</p></td>
<td class="parameter_description"><p>the index (starting at 0) at which to insert the page,
or -1 to append the page after all other pages</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-insert-page.returns"></a><h4>Returns</h4>
<p> the index (starting from 0) of the inserted
page in the notebook, or -1 if function fails</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-insert-page-menu"></a><h3>gtk_notebook_insert_page_menu ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_notebook_insert_page_menu (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu_label</code></em>,
                               <em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
<p>Insert a page into <em class="parameter"><code>notebook</code></em>
 at the given position, specifying
the widget to use as the label in the popup menu.</p>
<div class="refsect3">
<a name="gtk-notebook-insert-page-menu.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tab_label</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>menu_label</p></td>
<td class="parameter_description"><p>the widget to use as a label for the
page-switch menu, if that is enabled. If <code class="literal">NULL</code>, and <em class="parameter"><code>tab_label</code></em>
is a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> or <code class="literal">NULL</code>, then the menu label will be a newly
created label with the same text as <em class="parameter"><code>tab_label</code></em>
; if <em class="parameter"><code>tab_label</code></em>
is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, <em class="parameter"><code>menu_label</code></em>
must be specified if the
page-switch menu is to be used. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>position</p></td>
<td class="parameter_description"><p>the index (starting at 0) at which to insert the page,
or -1 to append the page after all other pages.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-insert-page-menu.returns"></a><h4>Returns</h4>
<p> the index (starting from 0) of the inserted
page in the notebook</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-remove-page"></a><h3>gtk_notebook_remove_page ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_remove_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                          <em class="parameter"><code><span class="type">gint</span> page_num</code></em>);</pre>
<p>Removes a page from the notebook given its index
in the notebook.</p>
<div class="refsect3">
<a name="gtk-notebook-remove-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_num</p></td>
<td class="parameter_description"><p>the index of a notebook page, starting
from 0. If -1, the last page will be removed.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-detach-tab"></a><h3>gtk_notebook_detach_tab ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_detach_tab (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Removes the child from the notebook.</p>
<p>This function is very similar to <a class="link" href="GtkContainer.html#gtk-container-remove" title="gtk_container_remove ()"><code class="function">gtk_container_remove()</code></a>,
but additionally informs the notebook that the removal
is happening as part of a tab DND operation, which should
not be cancelled.</p>
<div class="refsect3">
<a name="gtk-notebook-detach-tab.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a child</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-page-num"></a><h3>gtk_notebook_page_num ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_notebook_page_num (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                       <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Finds the index of the page which contains the given child
widget.</p>
<div class="refsect3">
<a name="gtk-notebook-page-num.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-page-num.returns"></a><h4>Returns</h4>
<p> the index of the page containing <em class="parameter"><code>child</code></em>
, or
-1 if <em class="parameter"><code>child</code></em>
is not in the notebook</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-next-page"></a><h3>gtk_notebook_next_page ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_next_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Switches to the next page. Nothing happens if the current page is
the last page.</p>
<div class="refsect3">
<a name="gtk-notebook-next-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-prev-page"></a><h3>gtk_notebook_prev_page ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_prev_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Switches to the previous page. Nothing happens if the current page
is the first page.</p>
<div class="refsect3">
<a name="gtk-notebook-prev-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-reorder-child"></a><h3>gtk_notebook_reorder_child ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_reorder_child (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                            <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                            <em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
<p>Reorders the page containing <em class="parameter"><code>child</code></em>
, so that it appears in position
<em class="parameter"><code>position</code></em>
. If <em class="parameter"><code>position</code></em>
 is greater than or equal to the number of
children in the list or negative, <em class="parameter"><code>child</code></em>
 will be moved to the end
of the list.</p>
<div class="refsect3">
<a name="gtk-notebook-reorder-child.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the child to move</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>position</p></td>
<td class="parameter_description"><p>the new position, or -1 to move to the end</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-tab-pos"></a><h3>gtk_notebook_set_tab_pos ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_tab_pos (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="type">GtkPositionType</span></a> pos</code></em>);</pre>
<p>Sets the edge at which the tabs for switching pages in the
notebook are drawn.</p>
<div class="refsect3">
<a name="gtk-notebook-set-tab-pos.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>pos</p></td>
<td class="parameter_description"><p>the edge to draw the tabs at</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-show-tabs"></a><h3>gtk_notebook_set_show_tabs ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_show_tabs (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                            <em class="parameter"><code><span class="type">gboolean</span> show_tabs</code></em>);</pre>
<p>Sets whether to show the tabs for the notebook or not.</p>
<div class="refsect3">
<a name="gtk-notebook-set-show-tabs.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>show_tabs</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the tabs should be shown</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-show-border"></a><h3>gtk_notebook_set_show_border ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_show_border (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                              <em class="parameter"><code><span class="type">gboolean</span> show_border</code></em>);</pre>
<p>Sets whether a bevel will be drawn around the notebook pages.
This only has a visual effect when the tabs are not shown.
See <a class="link" href="GtkNotebook.html#gtk-notebook-set-show-tabs" title="gtk_notebook_set_show_tabs ()"><code class="function">gtk_notebook_set_show_tabs()</code></a>.</p>
<div class="refsect3">
<a name="gtk-notebook-set-show-border.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>show_border</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if a bevel should be drawn around the notebook</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-scrollable"></a><h3>gtk_notebook_set_scrollable ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_scrollable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                             <em class="parameter"><code><span class="type">gboolean</span> scrollable</code></em>);</pre>
<p>Sets whether the tab label area will have arrows for
scrolling if there are too many tabs to fit in the area.</p>
<div class="refsect3">
<a name="gtk-notebook-set-scrollable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>scrollable</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if scroll arrows should be added</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-popup-enable"></a><h3>gtk_notebook_popup_enable ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_popup_enable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Enables the popup menu: if the user clicks with the right
mouse button on the tab labels, a menu with all the pages
will be popped up.</p>
<div class="refsect3">
<a name="gtk-notebook-popup-enable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-popup-disable"></a><h3>gtk_notebook_popup_disable ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_popup_disable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Disables the popup menu.</p>
<div class="refsect3">
<a name="gtk-notebook-popup-disable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-current-page"></a><h3>gtk_notebook_get_current_page ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_notebook_get_current_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Returns the page number of the current page.</p>
<div class="refsect3">
<a name="gtk-notebook-get-current-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-current-page.returns"></a><h4>Returns</h4>
<p> the index (starting from 0) of the current
page in the notebook. If the notebook has no pages,
then -1 will be returned.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-menu-label"></a><h3>gtk_notebook_get_menu_label ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_notebook_get_menu_label (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                             <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Retrieves the menu label widget of the page containing <em class="parameter"><code>child</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-get-menu-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a widget contained in a page of <em class="parameter"><code>notebook</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-menu-label.returns"></a><h4>Returns</h4>
<p>the menu label, or <code class="literal">NULL</code> if the
notebook page does not have a menu label other than the default (the tab
label). </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-nth-page"></a><h3>gtk_notebook_get_nth_page ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_notebook_get_nth_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> page_num</code></em>);</pre>
<p>Returns the child widget contained in page number <em class="parameter"><code>page_num</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-get-nth-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_num</p></td>
<td class="parameter_description"><p>the index of a page in the notebook, or -1
to get the last page</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-nth-page.returns"></a><h4>Returns</h4>
<p>the child widget, or <code class="literal">NULL</code> if <em class="parameter"><code>page_num</code></em>
is out of bounds. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-n-pages"></a><h3>gtk_notebook_get_n_pages ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_notebook_get_n_pages (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Gets the number of pages in a notebook.</p>
<div class="refsect3">
<a name="gtk-notebook-get-n-pages.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-n-pages.returns"></a><h4>Returns</h4>
<p> the number of pages in the notebook</p>
</div>
<p class="since">Since: 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-tab-label"></a><h3>gtk_notebook_get_tab_label ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_notebook_get_tab_label (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                            <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Returns the tab label widget for the page <em class="parameter"><code>child</code></em>
.
<code class="literal">NULL</code> is returned if <em class="parameter"><code>child</code></em>
 is not in <em class="parameter"><code>notebook</code></em>
 or
if no tab label has specifically been set for <em class="parameter"><code>child</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-get-tab-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-tab-label.returns"></a><h4>Returns</h4>
<p>the tab label. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-menu-label"></a><h3>gtk_notebook_set_menu_label ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_menu_label (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                             <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                             <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu_label</code></em>);</pre>
<p>Changes the menu label for the page containing <em class="parameter"><code>child</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-set-menu-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the child widget</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>menu_label</p></td>
<td class="parameter_description"><p>the menu label, or <code class="literal">NULL</code> for default. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-menu-label-text"></a><h3>gtk_notebook_set_menu_label_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_menu_label_text (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                  <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                  <em class="parameter"><code>const <span class="type">gchar</span> *menu_text</code></em>);</pre>
<p>Creates a new label and sets it as the menu label of <em class="parameter"><code>child</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-set-menu-label-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the child widget</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>menu_text</p></td>
<td class="parameter_description"><p>the label text</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-tab-label"></a><h3>gtk_notebook_set_tab_label ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_tab_label (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                            <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                            <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>);</pre>
<p>Changes the tab label for <em class="parameter"><code>child</code></em>
.
If <code class="literal">NULL</code> is specified for <em class="parameter"><code>tab_label</code></em>
, then the page will
have the label “page N”.</p>
<div class="refsect3">
<a name="gtk-notebook-set-tab-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tab_label</p></td>
<td class="parameter_description"><p>the tab label widget to use, or <code class="literal">NULL</code>
for default tab label. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-tab-label-text"></a><h3>gtk_notebook_set_tab_label_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_tab_label_text (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                 <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                 <em class="parameter"><code>const <span class="type">gchar</span> *tab_text</code></em>);</pre>
<p>Creates a new label and sets it as the tab label for the page
containing <em class="parameter"><code>child</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-set-tab-label-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tab_text</p></td>
<td class="parameter_description"><p>the label text</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-tab-reorderable"></a><h3>gtk_notebook_set_tab_reorderable ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_tab_reorderable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                  <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                  <em class="parameter"><code><span class="type">gboolean</span> reorderable</code></em>);</pre>
<p>Sets whether the notebook tab can be reordered
via drag and drop or not.</p>
<div class="refsect3">
<a name="gtk-notebook-set-tab-reorderable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>reorderable</p></td>
<td class="parameter_description"><p>whether the tab is reorderable or not</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-tab-detachable"></a><h3>gtk_notebook_set_tab_detachable ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_tab_detachable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                 <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                 <em class="parameter"><code><span class="type">gboolean</span> detachable</code></em>);</pre>
<p>Sets whether the tab can be detached from <em class="parameter"><code>notebook</code></em>
 to another
notebook or widget.</p>
<p>Note that 2 notebooks must share a common group identificator
(see <a class="link" href="GtkNotebook.html#gtk-notebook-set-group-name" title="gtk_notebook_set_group_name ()"><code class="function">gtk_notebook_set_group_name()</code></a>) to allow automatic tabs
interchange between them.</p>
<p>If you want a widget to interact with a notebook through DnD
(i.e.: accept dragged tabs from it) it must be set as a drop
destination and accept the target “GTK_NOTEBOOK_TAB”. The notebook
will fill the selection with a GtkWidget** pointing to the child
widget that corresponds to the dropped tab.</p>
<p>Note that you should use <a class="link" href="GtkNotebook.html#gtk-notebook-detach-tab" title="gtk_notebook_detach_tab ()"><code class="function">gtk_notebook_detach_tab()</code></a> instead
of <a class="link" href="GtkContainer.html#gtk-container-remove" title="gtk_container_remove ()"><code class="function">gtk_container_remove()</code></a> if you want to remove the tab from
the source notebook as part of accepting a drop. Otherwise,
the source notebook will think that the dragged tab was
removed from underneath the ongoing drag operation, and
will initiate a drag cancel animation.</p>
<div class="informalexample">
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
    <tbody>
      <tr>
        <td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20</pre></td>
        <td class="listing_code"><pre class="programlisting"><span class="k">static</span> <span class="kt">void</span>
<span class="n">on_drag_data_received</span> <span class="p">(</span><span class="n">GtkWidget</span>        <span class="o">*</span><span class="n">widget</span><span class="p">,</span>
                       <span class="n">GdkDragContext</span>   <span class="o">*</span><span class="n">context</span><span class="p">,</span>
                       <span class="n">gint</span>              <span class="n">x</span><span class="p">,</span>
                       <span class="n">gint</span>              <span class="n">y</span><span class="p">,</span>
                       <span class="n">GtkSelectionData</span> <span class="o">*</span><span class="n">data</span><span class="p">,</span>
                       <span class="n">guint</span>             <span class="n">info</span><span class="p">,</span>
                       <span class="n">guint</span>             <span class="n">time</span><span class="p">,</span>
                       <span class="n">gpointer</span>          <span class="n">user_data</span><span class="p">)</span>
<span class="p">{</span>
  <span class="n">GtkWidget</span> <span class="o">*</span><span class="n">notebook</span><span class="p">;</span>
  <span class="n">GtkWidget</span> <span class="o">**</span><span class="n">child</span><span class="p">;</span>

  <span class="n">notebook</span> <span class="o">=</span> <span class="n">gtk_drag_get_source_widget</span> <span class="p">(</span><span class="n">context</span><span class="p">);</span>
  <span class="n">child</span> <span class="o">=</span> <span class="p">(</span><span class="kt">void</span><span class="o">*</span><span class="p">)</span> <span class="n">gtk_selection_data_get_data</span> <span class="p">(</span><span class="n">data</span><span class="p">);</span>

  <span class="c1">// process_widget (*child);</span>

  <span class="n">gtk_notebook_detach_tab</span> <span class="p">(</span><span class="n">GTK_NOTEBOOK</span> <span class="p">(</span><span class="n">notebook</span><span class="p">),</span> <span class="o">*</span><span class="n">child</span><span class="p">);</span>
<span class="p">}</span></pre></td>
      </tr>
    </tbody>
  </table>
</div>

<p></p>
<p>If you want a notebook to accept drags from other widgets,
you will have to set your own DnD code to do it.</p>
<div class="refsect3">
<a name="gtk-notebook-set-tab-detachable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>detachable</p></td>
<td class="parameter_description"><p>whether the tab is detachable or not</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-menu-label-text"></a><h3>gtk_notebook_get_menu_label_text ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_notebook_get_menu_label_text (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                  <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Retrieves the text of the menu label for the page containing
<em class="parameter"><code>child</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-get-menu-label-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the child widget of a page of the notebook.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-menu-label-text.returns"></a><h4>Returns</h4>
<p>the text of the tab label, or <code class="literal">NULL</code> if the widget does
not have a menu label other than the default menu label, or the menu label
widget is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>. The string is owned by the widget and must not be
freed. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-scrollable"></a><h3>gtk_notebook_get_scrollable ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_notebook_get_scrollable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Returns whether the tab label area has arrows for scrolling.
See <a class="link" href="GtkNotebook.html#gtk-notebook-set-scrollable" title="gtk_notebook_set_scrollable ()"><code class="function">gtk_notebook_set_scrollable()</code></a>.</p>
<div class="refsect3">
<a name="gtk-notebook-get-scrollable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-scrollable.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if arrows for scrolling are present</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-show-border"></a><h3>gtk_notebook_get_show_border ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_notebook_get_show_border (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Returns whether a bevel will be drawn around the notebook pages.
See <a class="link" href="GtkNotebook.html#gtk-notebook-set-show-border" title="gtk_notebook_set_show_border ()"><code class="function">gtk_notebook_set_show_border()</code></a>.</p>
<div class="refsect3">
<a name="gtk-notebook-get-show-border.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-show-border.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the bevel is drawn</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-show-tabs"></a><h3>gtk_notebook_get_show_tabs ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_notebook_get_show_tabs (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Returns whether the tabs of the notebook are shown.
See <a class="link" href="GtkNotebook.html#gtk-notebook-set-show-tabs" title="gtk_notebook_set_show_tabs ()"><code class="function">gtk_notebook_set_show_tabs()</code></a>.</p>
<div class="refsect3">
<a name="gtk-notebook-get-show-tabs.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-show-tabs.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the tabs are shown</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-tab-label-text"></a><h3>gtk_notebook_get_tab_label_text ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_notebook_get_tab_label_text (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                 <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Retrieves the text of the tab label for the page containing
<em class="parameter"><code>child</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-get-tab-label-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a widget contained in a page of <em class="parameter"><code>notebook</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-tab-label-text.returns"></a><h4>Returns</h4>
<p>the text of the tab label, or <code class="literal">NULL</code> if the tab label
widget is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>. The string is owned by the widget and must not be
freed. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-tab-pos"></a><h3>gtk_notebook_get_tab_pos ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="returnvalue">GtkPositionType</span></a>
gtk_notebook_get_tab_pos (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Gets the edge at which the tabs for switching pages in the
notebook are drawn.</p>
<div class="refsect3">
<a name="gtk-notebook-get-tab-pos.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-tab-pos.returns"></a><h4>Returns</h4>
<p> the edge at which the tabs are drawn</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-tab-reorderable"></a><h3>gtk_notebook_get_tab_reorderable ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_notebook_get_tab_reorderable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                  <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Gets whether the tab can be reordered via drag and drop or not.</p>
<div class="refsect3">
<a name="gtk-notebook-get-tab-reorderable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-tab-reorderable.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the tab is reorderable.</p>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-tab-detachable"></a><h3>gtk_notebook_get_tab_detachable ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_notebook_get_tab_detachable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                 <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Returns whether the tab contents can be detached from <em class="parameter"><code>notebook</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-get-tab-detachable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-tab-detachable.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the tab is detachable.</p>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-tab-hborder"></a><h3>gtk_notebook_get_tab_hborder ()</h3>
<pre class="programlisting"><span class="returnvalue">guint16</span>
gtk_notebook_get_tab_hborder (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_notebook_get_tab_hborder</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>this function returns zero</p>
</div>
<p>Returns the horizontal width of a tab border.</p>
<div class="refsect3">
<a name="gtk-notebook-get-tab-hborder.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-tab-hborder.returns"></a><h4>Returns</h4>
<p> horizontal width of a tab border</p>
</div>
<p class="since">Since: 2.22</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-tab-vborder"></a><h3>gtk_notebook_get_tab_vborder ()</h3>
<pre class="programlisting"><span class="returnvalue">guint16</span>
gtk_notebook_get_tab_vborder (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_notebook_get_tab_vborder</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>this function returns zero</p>
</div>
<p>Returns the vertical width of a tab border.</p>
<div class="refsect3">
<a name="gtk-notebook-get-tab-vborder.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-tab-vborder.returns"></a><h4>Returns</h4>
<p> vertical width of a tab border</p>
</div>
<p class="since">Since: 2.22</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-current-page"></a><h3>gtk_notebook_set_current_page ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_current_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                               <em class="parameter"><code><span class="type">gint</span> page_num</code></em>);</pre>
<p>Switches to the page number <em class="parameter"><code>page_num</code></em>
.</p>
<p>Note that due to historical reasons, GtkNotebook refuses
to switch to a page unless the child widget is visible.
Therefore, it is recommended to show child widgets before
adding them to a notebook.</p>
<div class="refsect3">
<a name="gtk-notebook-set-current-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_num</p></td>
<td class="parameter_description"><p>index of the page to switch to, starting from 0.
If negative, the last page will be used. If greater
than the number of pages in the notebook, nothing
will be done.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-group-name"></a><h3>gtk_notebook_set_group_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_group_name (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                             <em class="parameter"><code>const <span class="type">gchar</span> *group_name</code></em>);</pre>
<p>Sets a group name for <em class="parameter"><code>notebook</code></em>
.</p>
<p>Notebooks with the same name will be able to exchange tabs
via drag and drop. A notebook with a <code class="literal">NULL</code> group name will
not be able to exchange tabs with any other notebook.</p>
<div class="refsect3">
<a name="gtk-notebook-set-group-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>group_name</p></td>
<td class="parameter_description"><p>the name of the notebook group,
or <code class="literal">NULL</code> to unset it. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-group-name"></a><h3>gtk_notebook_get_group_name ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_notebook_get_group_name (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
<p>Gets the current group name for <em class="parameter"><code>notebook</code></em>
.</p>
<div class="refsect3">
<a name="gtk-notebook-get-group-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-group-name.returns"></a><h4>Returns</h4>
<p>the group name, or <code class="literal">NULL</code> if none is set. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-set-action-widget"></a><h3>gtk_notebook_set_action_widget ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_notebook_set_action_widget (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> pack_type</code></em>);</pre>
<p>Sets <em class="parameter"><code>widget</code></em>
 as one of the action widgets. Depending on the pack type
the widget will be placed before or after the tabs. You can use
a <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> if you need to pack more than one widget on the same side.</p>
<p>Note that action widgets are “internal” children of the notebook and thus
not included in the list returned from <a class="link" href="GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()"><code class="function">gtk_container_foreach()</code></a>.</p>
<div class="refsect3">
<a name="gtk-notebook-set-action-widget.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>widget</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>pack_type</p></td>
<td class="parameter_description"><p>pack type of the action widget</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.20</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-notebook-get-action-widget"></a><h3>gtk_notebook_get_action_widget ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_notebook_get_action_widget (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
                                <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> pack_type</code></em>);</pre>
<p>Gets one of the action widgets. See <a class="link" href="GtkNotebook.html#gtk-notebook-set-action-widget" title="gtk_notebook_set_action_widget ()"><code class="function">gtk_notebook_set_action_widget()</code></a>.</p>
<div class="refsect3">
<a name="gtk-notebook-get-action-widget.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>pack_type</p></td>
<td class="parameter_description"><p>pack type of the action widget to receive</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-notebook-get-action-widget.returns"></a><h4>Returns</h4>
<p>The action widget with the given
<em class="parameter"><code>pack_type</code></em>
or <code class="literal">NULL</code> when this action widget has not been set. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.20</p>
</div>
</div>
<div class="refsect1">
<a name="GtkNotebook.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkNotebook-struct"></a><h3>struct GtkNotebook</h3>
<pre class="programlisting">struct GtkNotebook;</pre>
</div>
</div>
<div class="refsect1">
<a name="GtkNotebook.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkNotebook--enable-popup"></a><h3>The <code class="literal">“enable-popup”</code> property</h3>
<pre class="programlisting">  “enable-popup”             <span class="type">gboolean</span></pre>
<p>If TRUE, pressing the right mouse button on the notebook pops up a menu that you can use to go to a page.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--group-name"></a><h3>The <code class="literal">“group-name”</code> property</h3>
<pre class="programlisting">  “group-name”               <span class="type">char</span> *</pre>
<p>Group name for tab drag and drop.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--page"></a><h3>The <code class="literal">“page”</code> property</h3>
<pre class="programlisting">  “page”                     <span class="type">int</span></pre>
<p>The index of the current page.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: -1</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--scrollable"></a><h3>The <code class="literal">“scrollable”</code> property</h3>
<pre class="programlisting">  “scrollable”               <span class="type">gboolean</span></pre>
<p>If TRUE, scroll arrows are added if there are too many tabs to fit.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--show-border"></a><h3>The <code class="literal">“show-border”</code> property</h3>
<pre class="programlisting">  “show-border”              <span class="type">gboolean</span></pre>
<p>Whether the border should be shown.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--show-tabs"></a><h3>The <code class="literal">“show-tabs”</code> property</h3>
<pre class="programlisting">  “show-tabs”                <span class="type">gboolean</span></pre>
<p>Whether tabs should be shown.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--tab-pos"></a><h3>The <code class="literal">“tab-pos”</code> property</h3>
<pre class="programlisting">  “tab-pos”                  <a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="type">GtkPositionType</span></a></pre>
<p>Which side of the notebook holds the tabs.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: GTK_POS_TOP</p>
</div>
</div>
<div class="refsect1">
<a name="GtkNotebook.child-property-details"></a><h2>Child Property Details</h2>
<div class="refsect2">
<a name="GtkNotebook--c-detachable"></a><h3>The <code class="literal">“detachable”</code> child property</h3>
<pre class="programlisting">  “detachable”               <span class="type">gboolean</span></pre>
<p>Whether the tab is detachable.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--c-menu-label"></a><h3>The <code class="literal">“menu-label”</code> child property</h3>
<pre class="programlisting">  “menu-label”               <span class="type">char</span> *</pre>
<p>The string displayed in the child's menu entry.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--c-position"></a><h3>The <code class="literal">“position”</code> child property</h3>
<pre class="programlisting">  “position”                 <span class="type">int</span></pre>
<p>The index of the child in the parent.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--c-reorderable"></a><h3>The <code class="literal">“reorderable”</code> child property</h3>
<pre class="programlisting">  “reorderable”              <span class="type">gboolean</span></pre>
<p>Whether the tab is reorderable by user action.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--c-tab-expand"></a><h3>The <code class="literal">“tab-expand”</code> child property</h3>
<pre class="programlisting">  “tab-expand”               <span class="type">gboolean</span></pre>
<p>Whether to expand the child's tab.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--c-tab-fill"></a><h3>The <code class="literal">“tab-fill”</code> child property</h3>
<pre class="programlisting">  “tab-fill”                 <span class="type">gboolean</span></pre>
<p>Whether the child's tab should fill the allocated area.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--c-tab-label"></a><h3>The <code class="literal">“tab-label”</code> child property</h3>
<pre class="programlisting">  “tab-label”                <span class="type">char</span> *</pre>
<p>The string displayed on the child's tab label.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
</div>
<div class="refsect1">
<a name="GtkNotebook.style-property-details"></a><h2>Style Property Details</h2>
<div class="refsect2">
<a name="GtkNotebook--s-arrow-spacing"></a><h3>The <code class="literal">“arrow-spacing”</code> style property</h3>
<pre class="programlisting">  “arrow-spacing”            <span class="type">int</span></pre>
<p>The "arrow-spacing" property defines the spacing between the scroll
arrows and the tabs.</p>
<div class="warning">
<p><code class="literal">GtkNotebook:arrow-spacing</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
<p>This property is ignored. Use margins on arrows or
    the "tabs" node to achieve the same effect.</p>
</div>
<p>Owner: GtkNotebook</p>
<p>Flags: Read</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--s-has-backward-stepper"></a><h3>The <code class="literal">“has-backward-stepper”</code> style property</h3>
<pre class="programlisting">  “has-backward-stepper”     <span class="type">gboolean</span></pre>
<p>The “has-backward-stepper” property determines whether
the standard backward arrow button is displayed.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read</p>
<p>Default value: TRUE</p>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--s-has-forward-stepper"></a><h3>The <code class="literal">“has-forward-stepper”</code> style property</h3>
<pre class="programlisting">  “has-forward-stepper”      <span class="type">gboolean</span></pre>
<p>The “has-forward-stepper” property determines whether
the standard forward arrow button is displayed.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read</p>
<p>Default value: TRUE</p>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--s-has-secondary-backward-stepper"></a><h3>The <code class="literal">“has-secondary-backward-stepper”</code> style property</h3>
<pre class="programlisting">  “has-secondary-backward-stepper” <span class="type">gboolean</span></pre>
<p>The “has-secondary-backward-stepper” property determines whether
a second backward arrow button is displayed on the opposite end
of the tab area.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--s-has-secondary-forward-stepper"></a><h3>The <code class="literal">“has-secondary-forward-stepper”</code> style property</h3>
<pre class="programlisting">  “has-secondary-forward-stepper” <span class="type">gboolean</span></pre>
<p>The “has-secondary-forward-stepper” property determines whether
a second forward arrow button is displayed on the opposite end
of the tab area.</p>
<p>Owner: GtkNotebook</p>
<p>Flags: Read</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--s-has-tab-gap"></a><h3>The <code class="literal">“has-tab-gap”</code> style property</h3>
<pre class="programlisting">  “has-tab-gap”              <span class="type">gboolean</span></pre>
<p>The "has-tab-gap" property defines whether the active tab is draw
with a gap at the bottom. When <code class="literal">TRUE</code> the theme engine uses
gtk_render_extension to draw the active tab. When <code class="literal">FALSE</code>
gtk_render_background and gtk_render_frame are used.</p>
<div class="warning">
<p><code class="literal">GtkNotebook:has-tab-gap</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
<p>This function always behaves as if it was set to <code class="literal">FALSE</code>.</p>
</div>
<p>Owner: GtkNotebook</p>
<p>Flags: Read</p>
<p>Default value: TRUE</p>
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--s-initial-gap"></a><h3>The <code class="literal">“initial-gap”</code> style property</h3>
<pre class="programlisting">  “initial-gap”              <span class="type">int</span></pre>
<p>The "initial-gap" property defines the minimum size for the initial
gap between the first tab.</p>
<div class="warning">
<p><code class="literal">GtkNotebook:initial-gap</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
<p>The intial gap is ignored. Use margins on the header node
    to achieve the same effect.</p>
</div>
<p>Owner: GtkNotebook</p>
<p>Flags: Read</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--s-tab-curvature"></a><h3>The <code class="literal">“tab-curvature”</code> style property</h3>
<pre class="programlisting">  “tab-curvature”            <span class="type">int</span></pre>
<p>The “tab-curvature” property defines size of tab curvature.</p>
<div class="warning">
<p><code class="literal">GtkNotebook:tab-curvature</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
<p>This property is ignored. Use margins on tab nodes
    to achieve the same effect.</p>
</div>
<p>Owner: GtkNotebook</p>
<p>Flags: Read</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 1</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook--s-tab-overlap"></a><h3>The <code class="literal">“tab-overlap”</code> style property</h3>
<pre class="programlisting">  “tab-overlap”              <span class="type">int</span></pre>
<p>The “tab-overlap” property defines size of tab overlap
area.</p>
<div class="warning">
<p><code class="literal">GtkNotebook:tab-overlap</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
<p>This property is ignored. Use margins on tab nodes
    to achieve the same effect.</p>
</div>
<p>Owner: GtkNotebook</p>
<p>Flags: Read</p>
<p>Default value: 2</p>
<p class="since">Since: 2.10</p>
</div>
</div>
<div class="refsect1">
<a name="GtkNotebook.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkNotebook-change-current-page"></a><h3>The <code class="literal">“change-current-page”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
               <span class="type">int</span>          arg1,
               <span class="type">gpointer</span>     user_data)</pre>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook-create-window"></a><h3>The <code class="literal">“create-window”</code> signal</h3>
<pre class="programlisting"><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="returnvalue">GtkNotebook</span></a>*
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
               <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>   *page,
               <span class="type">int</span>          x,
               <span class="type">int</span>          y,
               <span class="type">gpointer</span>     user_data)</pre>
<p>The ::create-window signal is emitted when a detachable
tab is dropped on the root window.</p>
<p>A handler for this signal can create a window containing
a notebook where the tab will be attached. It is also
responsible for moving/resizing the window and adding the
necessary properties to the notebook (e.g. the
<a class="link" href="GtkNotebook.html#GtkNotebook--group-name" title="The “group-name” property"><span class="type">“group-name”</span></a> ).</p>
<div class="refsect3">
<a name="GtkNotebook-create-window.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> emitting the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page</p></td>
<td class="parameter_description"><p>the tab of <em class="parameter"><code>notebook</code></em>
that is being detached</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>the X coordinate where the drop happens</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>the Y coordinate where the drop happens</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="GtkNotebook-create-window.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> that <em class="parameter"><code>page</code></em>
should be
added to, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook-focus-tab"></a><h3>The <code class="literal">“focus-tab”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>   *notebook,
               <span class="type">GtkNotebookTab</span> arg1,
               <span class="type">gpointer</span>       user_data)</pre>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook-move-focus-out"></a><h3>The <code class="literal">“move-focus-out”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>     *notebook,
               <a class="link" href="gtk3-Standard-Enumerations.html#GtkDirectionType" title="enum GtkDirectionType"><span class="type">GtkDirectionType</span></a> arg1,
               <span class="type">gpointer</span>         user_data)</pre>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook-page-added"></a><h3>The <code class="literal">“page-added”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
               <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>   *child,
               <span class="type">guint</span>        page_num,
               <span class="type">gpointer</span>     user_data)</pre>
<p>the ::page-added signal is emitted in the notebook
right after a page is added to the notebook.</p>
<div class="refsect3">
<a name="GtkNotebook-page-added.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_num</p></td>
<td class="parameter_description"><p>the new page number for <em class="parameter"><code>child</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook-page-removed"></a><h3>The <code class="literal">“page-removed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
               <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>   *child,
               <span class="type">guint</span>        page_num,
               <span class="type">gpointer</span>     user_data)</pre>
<p>the ::page-removed signal is emitted in the notebook
right after a page is removed from the notebook.</p>
<div class="refsect3">
<a name="GtkNotebook-page-removed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_num</p></td>
<td class="parameter_description"><p>the <em class="parameter"><code>child</code></em>
page number</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook-page-reordered"></a><h3>The <code class="literal">“page-reordered”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
               <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>   *child,
               <span class="type">guint</span>        page_num,
               <span class="type">gpointer</span>     user_data)</pre>
<p>the ::page-reordered signal is emitted in the notebook
right after a page has been reordered.</p>
<div class="refsect3">
<a name="GtkNotebook-page-reordered.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>the child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_num</p></td>
<td class="parameter_description"><p>the new page number for <em class="parameter"><code>child</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook-reorder-tab"></a><h3>The <code class="literal">“reorder-tab”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>     *notebook,
               <a class="link" href="gtk3-Standard-Enumerations.html#GtkDirectionType" title="enum GtkDirectionType"><span class="type">GtkDirectionType</span></a> arg1,
               <span class="type">gboolean</span>         arg2,
               <span class="type">gpointer</span>         user_data)</pre>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook-select-page"></a><h3>The <code class="literal">“select-page”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
               <span class="type">gboolean</span>     arg1,
               <span class="type">gpointer</span>     user_data)</pre>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkNotebook-switch-page"></a><h3>The <code class="literal">“switch-page”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
               <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>   *page,
               <span class="type">guint</span>        page_num,
               <span class="type">gpointer</span>     user_data)</pre>
<p>Emitted when the user or a function changes the current page.</p>
<div class="refsect3">
<a name="GtkNotebook-switch-page.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>notebook</p></td>
<td class="parameter_description"><p>the object which received the signal.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page</p></td>
<td class="parameter_description"><p>the new current page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_num</p></td>
<td class="parameter_description"><p>the index of the page</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
</div>
</div>
<div class="refsect1">
<a name="GtkNotebook.see-also"></a><h2>See Also</h2>
<p><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>